docs: don't use <tag> docbook elements

diff --git a/gtk/gtkapplicationwindow.c b/gtk/gtkapplicationwindow.c
index ba99356c1068e0a9bcff69c8e9eb1ad40c9593b5..6ee95b1f1352ecaa7e340595fe3a0c79f61f78e7 100644 (file)
--- a/gtk/gtkapplicationwindow.c
+++ b/gtk/gtkapplicationwindow.c
@@ -111,16 +111,16 @@
  * ]|
  *
  * The XML format understood by #GtkBuilder for #GMenuModel consists
- * of a toplevel <tag class="starttag">menu</tag> element, which contains
- * one or more <tag class="starttag">item</tag> elements. Each
- * <tag class="starttag">item</tag> element contains
- * <tag class="starttag">attribute</tag> and <tag class="starttag">link</tag>
+ * of a toplevel `&lt;menu&gt;` element, which contains
+ * one or more `&lt;item&gt;` elements. Each
+ * `&lt;item&gt;` element contains
+ * `&lt;attribute&gt;` and `&lt;link&gt;`
  * elements with a mandatory name attribute.
- * <tag class="starttag">link</tag> elements have the same content
- * model as <tag class="starttag">menu</tag>.
+ * `&lt;link&gt;` elements have the same content
+ * model as `&lt;menu&gt;`.
  *
  * Attribute values can be translated using gettext, like other #GtkBuilder
- * content. <tag class="starttag">attribute</tag> elements can be marked for
+ * content. `&lt;attribute&gt;` elements can be marked for
  * translation with a <literal>translatable="yes"</literal> attribute.
  * It is also possible to specify message context and translator comments,
  * using the context and comments attributes. To make use of this, the

diff --git a/gtk/gtklabel.c b/gtk/gtklabel.c
index ab769f1aae6a8165512cfb788f6a6be549ac1dc8..6ca271c5e2e402930ba1f40d7f7e025782d50ea5 100644 (file)
--- a/gtk/gtklabel.c
+++ b/gtk/gtklabel.c
@@ -200,11 +200,12 @@
  *
  * Since 2.18, GTK+ supports markup for clickable hyperlinks in addition
  * to regular Pango markup. The markup for links is borrowed from HTML, using the
- * <tag>a</tag> with href and title attributes. GTK+ renders links similar to the
+ * `&lt;a&gt;` with href and title attributes. GTK+ renders links similar to the
  * way they appear in web browsers, with colored, underlined text. The title
  * attribute is displayed as a tooltip on the link.
  *
  * An example looks like this:
+ *
  * |[<!-- language="C" -->
  * gtk_label_set_markup (label, "Go to the <a href="http://www.gtk.org" title="&lt;i&gt;Our&lt;/i&gt; website">GTK+ website</a> for more...");
  * ]|

diff --git a/gtk/gtkoverlay.c b/gtk/gtkoverlay.c
index 420515309598c5105346bdf9a96d2ebbdca7bb86..084db86f67aa3137570ac7448bd53c3e74fd0e82 100644 (file)
--- a/gtk/gtkoverlay.c
+++ b/gtk/gtkoverlay.c
@@ -50,7 +50,7 @@
  *
  * The GtkOverlay implementation of the GtkBuildable interface
  * supports placing a child as an overlay by specifying "overlay" as
- * the "type" attribute of a <tag class="starttag">child</tag> element.
+ * the "type" attribute of a `&lt;child&gt;` element.
  */
 
 struct _GtkOverlayPrivate

diff --git a/gtk/gtkwindow.c b/gtk/gtkwindow.c
index d70b74dc7b52f5366e38a2003d02e175857ce21b..a0377ce9abff871bb4052f967a79ea05d0bb4938 100644 (file)
--- a/gtk/gtkwindow.c
+++ b/gtk/gtkwindow.c
@@ -92,8 +92,8 @@
  * ## GtkWindow as GtkBuildable
  *
  * The GtkWindow implementation of the GtkBuildable interface supports a
- * custom <tag class="starttag">accel-groups</tag> element, which supports
- * any number of <tag class="starttag">group</tag> elements representing the
+ * custom `&lt;accel-groups&gt;` element, which supports
+ * any number of `&lt;group&gt;` elements representing the
  * #GtkAccelGroup objects you want to add to your window (synonymous with
  * gtk_window_add_accel_group().
  *
@@ -112,7 +112,7 @@
  * 
  * The GtkWindow implementation of the GtkBuildable interface
  * supports setting a child as the titlebar by specifying "titlebar" as
- * the "type" attribute of a <tag class="starttag">child</tag> element.
+ * the "type" attribute of a `&lt;child&gt;` element.
  */
 
 #define MNEMONICS_DELAY 300 /* ms */